.. _cmlMxStopEmg:

cmlMxStopEmg
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

  VT_I4 cmlMxStopEmg ([in] VT_I4 BoardID, [in] VT_I4 NumAxes, [in] VT_PI4 NumChannel) 

DESCRIPTION
`````````````  

- 지정한 모든 축에 대한 모션을 정지(停止)합니다. cmlMxStop()  함수는 정지(停止)시에 감속 후 
  정지(停止)를 수행하며, cmlMxStopEmg() 함수는 감속없이 즉시정지(停止)를 수행합니다. 
 
\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.

PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NumAxes : 동시에 작업을 수행할 대상 축의 수 
 
▶ NumChannel : 동시에 작업을 수행할 대상 축의 배열 주소값. 이 배열의 크기는 
NumAxes값과 일치하거나 커야 합니다. 
                

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

REFERENCE
`````````````

.. note:: "윈도우 이벤트라는 것은 무엇입니까?"
    윈도우 운영체제는 Event Driven 혹은 Message Driven 방식의 구조로 되어 
    있습니다. 각 응용프로그램은 메시지 큐(Queue)를 가지고 있으며, 정확히 
    말하면, 메시지를 사용해 이벤트를 통지하는 방식으로 설계되어 있습니다. 
    윈도우 메시지를 처리한다는 것은 메시지 큐에서 메시지를 하나씩 꺼내서 
    윈도우 프로시저에 전송한다는 것을 의미하며, 이것은 그 행선지가 되는 
    윈도우에 전송되어 처리됩니다. 

EXAMPLE
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

  C/C++  
  Long BoardID = 0; 
  void CmlMotionDlg::OnStop()  
  { 
  long nAxes[4]={0, 1, 2, 3}; 
  GetDlgItcml(IDC_btnStop)->EnableWindow(FALSE); 
  cmlMxStop(BoardID, 4, nAxes); 
  GetDlgItcml(IDC_btnStop)->EnableWindow(TRUE); 
  } 

.. code-block:: c++
 :linenos:

  Visual Basic 
  Private Sub btnStop_Click()     
  Dim nRetVal As Long 
  Dim BoardID As Long 
  Dim NumChannel(2) As Long 
  BoardID = 0 
  NumChannel(0) = 0 
  NumChannel(1) = 1 
  ' 각 인자에 대한 설명을 드립니다. 
  ' MxStop( 축 갯수, 배열, 완료대기여부, 블록여부) 
  ' 1. 축 갯수 
  ' 다축제어에서 배열 요소에 해당하는 대상 축의 갯수입니다. 
  ' 2. ë°°ì—´ 
  ' 축 배열을 전달합니다. 이 배열 내부의 축은 X, Y, Z, U 축을 기본으로  
  하지만 사용자가 원하는 축의 조합 (예 : X1, Y2, U1, Z1) 등의 조합의  
  배열로도 전달 할 수 있습니다. 
  ' 단 '1. 축 갯수'는 대상 축의 총 갯수입니다 
  ' 3. 완료 대기 여부 
  ' MxStop 함수의 이 인자의 값이 True 일 경우 함수는 정지(停止) 명령을  
  ' 송달한 후  반환하지 않습니다. 
  ' 만약 False 일 경우 정지(停止) 완료까지 기다리지 않습니다. 
  ' 4. 블록 여부 
  ' 이 매뉴얼에서 설명한 내용이므로 생략합니다. 
  nRetVal = MxStop(BoardID, 3, NumChannel(0)) 
  End Sub

.. code-block:: c++
 :linenos:

  Delphi 
  // * Description : 
  // * 이 함수는 버튼 이벤트에 의해 모션 동작을 정지(停止)하는 함수입니다. 
  // * 
  procedure btnStopClick(); 
  var 
  BoardID : LongInt; 
  NumChannel : Array[0..1] of LongInt; 
  gnTargetAxis : LongInt; 
  begin 
  end; 
  BoardID := 0; 
  NumChannel[0] := 0; 
  NumChannel[1] := cmY1; 
  gnTargetAxis := 2; 
  // 정지(停止) 함수의 원형은 cmlSxStop(BoardID, [TargetAxis], [IsWaitComplete],   
  // [IsBlocking]) 입니다. 
  // TargetAxis : 정지(停止) 할 대상 축을 설정합니다. 
  cmlMxStop(BoardID, gnTargetAxis, @NumChannel);